home *** CD-ROM | disk | FTP | other *** search
/ Aminet 20 / Aminet 20 (1997)(GTI - Schatztruhe)[!][Aug 1997].iso / Aminet / comm / www / CountryCodes.lha / countrycodes / CountryCodes.doc < prev    next >
Text File  |  1997-06-22  |  6KB  |  158 lines
  1.  
  2.   CountryCodes v1.0 - Copyright 1997 by Paul Kolenbrander All Rights Reserved!
  3.  
  4. ------------
  5. DESCRIPTION:
  6. ------------
  7.  
  8. Welcome to CountryCodes. In our evergrowing InterNet, we start to wonder where
  9. the people are located who'se e-mail we get and who'se pages we visit. It is 
  10. not hard to find that out, as most addresses have a suffix that denotes which
  11. country. CountryCodes strives to make it easy for you to locate the cuntry in
  12. question by inputting the suffix. It has an easy to use standard Amiga GUI and
  13. requires no 3rd party libraries. All that is needed is for you to input the 
  14. suffix in the leftmost field and hit the RETURN key. In the rightmost field
  15. the country associated with that suffix will then be shown. If you input an
  16. invalid suffix, the program wil tell you as well. It does not matter of you 
  17. input the suffix in upper/lower case or with/without the period. Like .nl,
  18. .NL, nl and NL are all allowed.
  19.  
  20.     +---------------------------------------------------------------+
  21.     |o| CountryCodes v1.0, ©1997 Paul Kolenbrander              | | |
  22.     +---------------------------------------------------------------+
  23.     |           ______  ___________________________________________ |
  24.     | Suffix : |______||___________________________________________||
  25.     |                                                               |
  26.     +---------------------------------------------------------------+
  27.                   |         |
  28. Input Suffix -----+         +----- Shows associated country.
  29.  
  30.  
  31. It allows for a number of CLI parameters and Tooltypes. Which are:
  32.  
  33. 'PUBSCREEN=' Enables you to specify a public screen CountryCodes is to open it's
  34.              window on. Default value for this parameter is the Workbench
  35.              screen. Usage: PUBSCREEN=Edit_screen.
  36.  
  37. 'FONTNAME='  Specify the (fixed width) font to use. Usage: FONTNAME=Topaz.font
  38.  
  39. 'FONTSIZE='  Specify the size of the font to use. Usage: FONTSIZE=11
  40.  
  41. 'TOPEDGE='   Y position for the window to open on. Usage: TOPEDGE=10
  42.  
  43. 'LEFTEDGE='  X position for the window to open on. Usage: LEFTEDGE=50
  44.  
  45. 'ZOOMTOP='   X position of iconified window. Usage: ZOOMTOP=30
  46.  
  47. 'ZOOMLEFT='  Y position of iconified window. Usage: ZOOMLEFT=20 
  48.  
  49. ---------------
  50. AREXX COMMANDS:
  51. ---------------
  52.  
  53. Of course no Amiga program would complete without an ARexx Host. CountryCodes
  54. is no exception to this rule. It has an extensive ARexx host allowing you to
  55. activate, send to back, bring to front and move it's window. It also supports
  56. the suffix being sent via ARexx instead of inputted directly. Allowing for the
  57. construction of scripts that should easily interface with any mailer/newsreader
  58. or WWW browser with ARexx support. The ARexx hostname for the program is COCO1.
  59. Any subsequent hosts are named: COCOx (where x is a number).
  60.  
  61.  
  62. LOCATE suffix               - Locate the country associated with suffix.
  63.  
  64. WINDOW ACTIVATE             - Activate the window.
  65.  
  66. WINDOW MOVE xval yval       - Move the window. Always specify both the x and y
  67.                               values. Eg. WINDOW MOVE 0 10.
  68. WINDOW BACK                 - Push the window back.   
  69.  
  70. WINDOW FRONT                - Bring the window back to the front.
  71.  
  72. WINDOW POSITION             - Returns the window x and y position as well as
  73.                               it's width and height. Eg. '10 200 566 89'
  74.  
  75. QUIT                        - End the program.
  76.  
  77.  
  78. To move CountryCodes window to front (assuming ARexx host is COCO1) : 
  79. rx 'ADDRESS COCO1 WINDOW FRONT'
  80.  
  81. To move CountryCodes window 50 pixels to the right and 10 down:
  82. rx 'ADDRESS COCO1 WINDOW MOVE 50 10'
  83.  
  84. To find out which country is associated with eg. .nl:
  85. rx 'ADDRESS COCO1 LOCATE nl'
  86.  
  87. And to end CountryCodes:
  88. rx 'ADDRESS COCO1 QUIT'
  89.  
  90. Finally a small script to get the CountryCodes window position:
  91. ------------------------- Script Begin ------------------------- 
  92. /* Get Window position */
  93.  
  94. options results
  95.  
  96. ADDRESS COCO1 WINDOW POSITION
  97. say 'The CountryCodes window position is '||result
  98. exit
  99. -------------------------- Script End -------------------------- 
  100.  
  101. The program does send return codes that can be evaluated by your arexx
  102. script to determine if the command was succesful.
  103.  
  104. -------------------------
  105. DISTRIBUTION & COPYRIGHT:
  106. -------------------------
  107.  
  108. CountryCodes is copyrighted by Paul Kolenbrander (paul@serena.iaehv.nl) and
  109. all rights are reserved.  It is distributed as giftware with a number of
  110. distribution and usage limitations.
  111.  
  112. 1. It is not public domain, but may be freely used by private persons.  
  113.    If you feel it useful, a small token of your appreciation is always
  114.    welcome. I love Bundy rum, Toohey's Draught, Mounds and cashew nuts.
  115.    StarTrek related items are also very welcome. And I'd not say no to
  116.    a gift of a Mustang Convertible or a 'Vette. *being optimistic here*
  117.  
  118. 2. It may not be bundled with any commercial program unless I receive
  119.    a full copy of said program for free. 
  120.  
  121. 3. It may not be bundled with any shareware program unless I receive
  122.    a full copy of said program for free. 
  123.  
  124. 4. It may not be distributed on any CD or magazine cover or by any
  125.    other means without first obtaining my written authorisation. The
  126.    AmiNet CD's hereby receive such authorisation.
  127.  
  128. 5. Use by commercial or government organisations is subject to a 
  129.    licensing fee. Contact the author for further information.
  130.  
  131. 6. This document, unaltered, must always accompagny the CountryCodes
  132.    program.
  133.  
  134. -----------------
  135. ARCHIVE CONTENTS:
  136. -----------------
  137.  
  138. CountryCodes            - The actual program.
  139. CountryCodes.info       - It's icon.
  140. CountryCodes.doc        - The documentation. This file.
  141. CountryCodes.doc.info   - It's icon.
  142. extractsuffix.rexx      - Generic example ARexx script.
  143. awebextractsuffix.rexx  - ARexx script for use with AWeb.
  144. cedextractsuffix.rexx   - ARexx script for use with CygnusEd 3.5.
  145.  
  146. ----------------------
  147. CONTACTING THE AUTHOR:
  148. ----------------------
  149.  
  150. Well, that's easy, take your pick:
  151.  
  152. E-Mail   : paul@serena.iaehv.nl
  153.  
  154. Snailmail: Paul Kolenbrander
  155.            Postbus 5295
  156.            NL-5603 BD  EINDHOVEN
  157.            THE NETHERLANDS
  158.